Skip to main content

Service Quotes

A Service Quote is a price estimate generated for an order based on matching Service Rates. Quotes allow operators and customers to review and accept pricing before a delivery is committed.

How Quotes Are Generated

When an order is created (or when explicitly requested), Mative Cloud Fleet Management evaluates all active Service Rates and generates quotes for any that match the order's:

  • Origin and destination (service area / zone)
  • Order type (Order Configuration)
  • Payload details (weight, volume, parcel count)
  • COD amount and payment method
  • Scheduled time (for peak-hour surcharges)

Generated quotes include: amount, currency, and expiry time.

Viewing Quotes on an Order

Active quotes appear in the Order Detail Panel:

FieldDescription
AmountCalculated price
CurrencyQuote currency
Applied RateWhich Service Rate was used
ExpiryTimestamp when this quote expires
AcceptButton to accept and attach the quote to the order

Quote Workflows

Operator-Managed Flow

  1. Operator creates an order
  2. Mative Cloud Fleet Management automatically generates quotes
  3. Operator reviews and accepts a quote
  4. Order is dispatched with the accepted quote linked as a transaction

Customer-Facing Flow (API / Storefront)

  1. Customer submits order details
  2. API returns available quotes
  3. Customer selects preferred service tier
  4. Order is created with the selected quote linked

Generating Quotes via API

GET /v1/service-quotes

Parameters:

ParameterDescription
payloadPayload object with pickup/dropoff/entities
pickupOrigin location
dropoffDestination
waypointsArray of intermediate stops
service_typeOrder Configuration type
scheduled_atScheduled time (affects peak-hour rates)
codCash-on-delivery amount
currencyRequested currency

Quote Expiry

Quotes have a configurable expiry time. After expiry, the quote is no longer valid and a new quote must be generated. This prevents stale prices from being applied to orders.

Multiple Quotes

When multiple Service Rates match an order, multiple quotes are generated — allowing customers or operators to select the preferred service tier (e.g., express vs. standard delivery).

Payment Integration

Accepted quotes can connect to payment gateways (e.g., Stripe) for online customer charging when configured in Fleet Management → Settings → Payments.